[ <<>> ] Succubus Heart [ <<>> ]
[<>] The Succubus Gameplay Mod [<>]

created by : Michael Stanich aka Spirit Shard
Site - michaelpstanich.com
YouTube - youtube.com/michaelpstanich
Twitter - twitter.com/Michael_Stanich


[ <<>>] Self Promotion [ <<>> ]
So.. I work hard on the mod, but I also work hard at making YouTube Videos! If you're looking for a great Gaming and Design focused YouTube channel and creator please check me out at https://www.youtube.com/michaelpstanich ! I also run a gaming Discord Community called "The Broken Chatbox" ( https://discord.gg/v9cbQrx ). We're small now, but to growth we go!~

Also I do game-dev stuff, but it's "hush-hush" till a playable alpha... (My social media will explode with details when it's available)

[ <<>> ] Latest News [ <<>> ]
Succubus Heart 4.18 is released! The Succubus Realm finally got a long awaited update to look more toward how I originally intended. Also made some Quality of Life changes, starting to transition things into menus and remove a lot of the spell redundencies.

SSE SKSE NEWS!!!
SKSE has released its alpha for SSE, however I believe functionality is still limited and will be waiting for SexLab to be ported over. Just as a reminder I do plan to make an SSE version, however development will continue primarily on 'vanilla' skyrim unless SSE offers something crucial after all goals are met (which it probably wont).

_____

[ <<>> ] What is Succubus Heart? [ <<>> ]
Succubus Heart is an adult gameplay mod focused on creating new ways to approach playing Skyrim with both new progression and new game mechanics. These mechanics give the player the power of a succubus enabling the use of life-drain and great sacrificial powers. Succubus Heart is built around the idea of being a complimentary mod and should be compatible with nearly every mod out there!

[ <<>> ] What's So Unique? [ <<>> ]
Succubus Heart isn't a transformation mod, or a power fantasy mod, instead mechanics are focused on making gameplay more interesting and offering the player new ways to approach situations. Succubus Heart can also be used on male characters, turning them into a soul sucking Incubus! While most succubus mods focus on the demon-archtype Succubus Heart's approach is based on a fantasy race of life-weavers giving a more human-but-powerful vibe. However if you want some succubus transformations or want to use Succubus Heart alongside other succubus mods nothing is stopping you!

[ <<>> ] Mechanics [ <<>> ]
Heart System : Your succubus will earn XP through sexual acts and certain items which can be spent to learn new and improve their existing abilities! You'll also absorb life force from your partners, permanently decreasing their status while improving your own!

Skill Leveling : Take your overflowing life force and level Skyrim's usual Skills using SP earned. You can also convert any unwanted XP into SP if so desired.

Sex Drops : Orgasms will give partners their special juices (Sperm and Milk) which can be consumed or used in alchemy! There's also a chance at getting rare drops which have special effects when consumed (or you can be boring and use them in alchemy...).

Death Drops : After death characters will keep a small soul item which can then be taken and used by the player for various bonuses.

Succubus Passives : Unlock and rank up a variety of Succubus Passives which give advantages in combat, make progression run more smoothly, or just makes things a bit more... appealing.

Soul Pets : Another mod fully integrated into Succubus Heart with unique features! Soul Pets are summonable followers (both creature and human) which level through acts. As levels increase not only do pets become more powerful but the summoner's abilities improve adding new bonuses and unlocking more summons!

Combat Seduction : A simple combat submit mod, built right in! Initially built for testing, the feature can be handy if you're looking for a light-weight alternative to other submit mods. However I recommend disabling this feature if you have other submit mods running to avoid issues.

Death Override Mode : A simple Death Alternative which respawns the player when health hits 0 instead of just prompting a reload. You can even turn Skyrim into a 'rogue-lite' by enabling item loss on death, introducing new gameplay approaches! I recommend leaving this disabled if you use any other Death Alternative type mod.

[ <<>> ] Help Section (Included in-game) [ <<>> ]
[Spoiler]
Basic Mechanics
 - Earning XP
 - - - XP [Short for 'Heart XP'] is obtained through Sex Acts and various items [such as milk/sperm]. XP can then be spent on various upgrades for your character. [Advanced notes available]
 - Earning SP :
 - - - SP [Short for 'Skill Points'] is obtained when absorbing over the max-status allowed. When status is absorbed, any amount over the player's cap is turned into 'Force', then once enough Force is obtained an SP is earned. SP can then be spent on leveling Skills. Optionally XP can be converted into Force to earn SP more quickly. [Advanced notes available]
 - Desire :
 - - - Desire generates naturally over time [this value can also be configured in the Settings Menu]. Desire is consumed in Sex Acts and by some Passives to provide a bonus. Optionally in the Settings Menu negative effects can be added to having high Desire. [Advanced Notes Available]
 - Absorption :
 - - - While in Sex Acts a Succubus/Incubus will drain partners of their Status, taking Max Health/Magicka/Stamina and increasing their own Max Health/Magicka/Stamina. When the player is involved the amount absorbed is determined by their Absorption Stats [which can be leveled with XP] however they can only earn Status up to their Cap [The Status Caps increase by 2 each Player Level and can also be increased with XP]. NPC Absorption stats and caps are all based on Level. [Note : When player is an aggressor 20% is added, while as a victim 20% is subtracted]
 - Stacks :
 - - - Sex/Sperm/Milk Stacks are earned by Orgasms/Consuming Sperm/Consuming Milk and are used by Passives for different bonuses. Instead of being Consumed Stacks Decay over time. Sex Stacks will decrease by 1 every 5 minutes, while Sperm/Milk Stacks will decrease by 1 every minute. Max Stacks and Stacks Earned can be increased with XP and Passives respectively. [Note: Stacks can't go below Zero.
 - Sex Drops :
 - - - Sex Drops are items obtained through character Orgasms. There are 2 types of Sex Drops, Basic and Rare. Basic drops are Sperm and Milk, these are always given to a character's partner when they orgasm. Rare Drops are special items given along-side sperm/milk, these items give large bonuses to the player and are fairly value-able, but they don't always drop and are fairly rare.
 - Death Drops :
 - - - Death Drops are items obtained from characters that die. When a character dies a 'Soul' item is added to their inventory, which can then be looted by the player. These souls provide different bonuses and act as a stable way for the player to progress without Sex Acts. These drops range from common to rare.
 - Soul Pets :
 - - - Soul Pets is external mod, integrated fully into Succubus Heart! Soul Pets allows several pets to be summoned, each gaining XP as they fight or participate in Sex Acts. Upon a Pet Level, Summoner XP is gained, which can then increase the Summoner Level. To unlock new Pets and Abilities higher Levels will be required. Pets also generate Desire when no pet is summoned, however when summoned they consume desire and when reaching zero, or below, they will be un-summoned.
 - Succubus Realm :
 - - - The Succubus Realm [which can be entered/exited using the connect/disconnect spells provided, fast travel can also be used to exit] is the 'Realm of the Heart' and acts as another world separated from Skyrim. This realm contains Succubus and Incubus NPCs along with a location for the player to explore. The Realm Entrances also provide a decent 'home base' location.
 - Combat Seduction :
 - - - Combat Seduction is a built-in Combat Submit mod! This feature has characters fall victim to aggressors [starts sex acts] when characters fall below the configured Health Thresholds. Combat Seduction is built to be light weight however it lacks any advanced features, so while it stands on it's own fairly well those looking for advanced features should make sure to disable this if they use any other Combat Submit mod.
 - Death Override :
 - - - Death Override Mode is a built-in Death Alternative mod! With this feature the player will transport back into the Succubus Realm instead of dieing. Various effects can be configured to customize what effects this has. Disable if you use any other Death Alternative mods, or else things WILL break. [Note: The core design of Death Override Mode is to create Rogue-light features and encourage careful play]

Advanced Mechanics
 - Tracking :
 - - - Use the 'set to default' key on anything that requires XP to level and the required XP will be tracked (Will show a 'Tracking Set' message if done properly). Upon obtaining the proper XP a notification will let you know the selected ability can be level.
 - XP Mechanics :
 - - - When earning XP a few factors go into play, the base earning value [Determined by the act/item/spell/mod], Player level [adds a small bonus to the base value, determined by the act/item/spell/mod], XP Gain Stat [As expected, if the base is 10XP with a 110% XP gain stat, you earn 11XP instead], and Desire [Explained in Desire Consumption]. [Note : When player is an aggressor 20% is added, while as a victim 20% is subtracted]
 - SP Mechanics :
 - - - SP requires Force to obtain, however the required amount is modified in a few ways. For every SP earned through Force Conversion [reaching the required Force value] the cost for another SP increases, however the value needed decreases with each Player Level. The Force Master Passive can also decrease the Force requirement.
 - Desire Consumption :
 - - - Desire currently only offers boosts within Sex Acts. While in an Act 5% Desire is consumed each tick and is added directly into the XP earned that tick. Upon orgasm 80% Desire is consumed and added directly into the XP earned.
 - BDSM Rating :
 - - - Body Desire Soul Mind rating represent the Player Character's Succubus Rating. Improving different abilities will increase the overall BDSM Rating while learning Passives will decrease this rating, both improving abilities and learning Passives will increase different traits. BDSM will display a dominate trait based on the rating with the highest value, which can then alter the effects of some Passives.
 - Passives :
 - - - Passives will give the Player Character 'always on' abilities which trigger under specific conditions. Each Passive may have multiple paths which will change different aspects of each passive and can be ranked up just like abilities. BDSM Rating is required to learn Passives, acting similar to XP or SP and increasing as the Passive levels, however Passives can be reset at any time, returning the BDSM Rating to where it was.
[/Spoiler]

[ <<>> ] WARNING : Script Mod [ <<>> ]
While Succubus Heart is fairly light weight in the majority of cases it is a heavily script based mod. If your game is already having issues with script latency and overload I recommend backing up your saves before trying out Succubus Heart (and/or possibly decreasing your script load). I've done what I can to ensure Succubus Heart is as bug/error free as possible however under script lag any mod can begin throwing up errors and I can't guarantee Succubus Heart's performance.

[ <<>> ] What's Included [ <<>> ]
- Docs (Read Me - ChangeLog - Source Notes)
- Data (Everything for the core mod)
- Optional Uncapper Settings (Customized Skyrim Com. Unc. Settings)

[ <<>> ] Requirements [ <<>> ]
- Skyrim (Vanilla)
- SKSE 1.07.03 or newer [ http://skse.silverlock.org/ ]
- SexLab v1.62 or newer
- Sky UI 5.1 or newer [ http://www.nexusmods.com/skyrim/mods/3863/? ]

[ <<>> ] Recommended Mods [ <<>> ]
- Skyrim Community Uncapper [ http://www.nexusmods.com/skyrim/mods/1175/? ]

[ <<>> ] Installing / Updating [ <<>> ]
Installing : Simply copy Succubus Heart's "Data" folder to your Skyrim install, merging with that "Data" folder, then install any optional content you wish to use.

Updating : If you're using version 2.73x or below you'll need to do a 'clean' save before moving to 3.0+.

[ <<>> ] Uninstalling / Removal [ <<>> ]
Disable the mod then perform a clean save. After the clean save delete the "Succubus Heart.esp" and all files pre-fixed with "SuH_" and other files from the Succubus Heart mod from your Skyrim's "Data" folder. It is recommended to either load a game from before you had Succubus Heart installed or start a new game after uninstalling.

[ <<>> ] External Mod Support [ <<>> ]
Succubus Heart features are easy to access and modify, if anyone wants to create add-ons and additional mods feel free! If you have questions or any issues feel free to message me.

[ <<>> ] Incompatible Mods [ <<>> ]
- AFT/UFO (Advanced Follower Tweaks / Ultimate Follower Overall) is incompatible with Soul Pets. While using these mods expect issues when using Soul Pets. (and no, I can't fix them, AFT/UFO need to be updated with skyrim's creature handling.)
- Any mod that 'locks' player status or tries to manage stats based on non-dynamic values. (Succubus Heart dynamically changes values and can have issues with mods that try to do this with Skyrim's default values without dynamically checking. Sadly this is on them and there's nothing I can do about it.)
- Regal Glow applies an 'invisible' armor and can cause some issues with mods detecting nudity. In these cases add an exception to 'SuH_armor_regalglow' or the blank name entry in the mod's exception MCM (if it has one).

[ <<>> ] Known Issues [ <<>> ]
- Horse Pet may fast travel with you if you don't already own a primary horse.
- Using Soul Pets with other Animal Follower mods may cause strange behavior on both mods. (I recommend not summoning a Soul Pet while the other Animal Follower is following you)
- Soul Pets will sometimes and sometimes not teleport to the player when they should or shouldn't, if your pet is missing just re-summon them.
- Combat Seduction will sometimes trigger 'overlapping' animations under heavy script lag
- Death Override Mode can cause major issues with certain quests if you die and move outside of the quest's dedicated area. (When in this situation disable Death Override for the quest's duration)
- General script latency problems do to the nature of script modding (Heavy script lag may cause issues with Succubus Heart)

[ <<>> ] FAQ [ <<>> ]
Q: Is this mod still being developed and updated?
A: Short answer is yes, long answer is a bit more complicated. The framework for everything is now built, so all that is left now is to bug fix and add in more spells/effects/whatever. While I still work on the mod from time to time updates will usually be far apart since I have many other projects + a day job to tend to. If anyone wants to add in new features themselves I'm all for it, just contact me if you run into any problems and I'll help when/where I can!

Q: Can I still level like in vanilla?
A: Of course! Succubus Heart doesn't alter any external scripts so other leveling methods should work as they always have.

Q: Can I use this mod as a male character?
A: Yep! Succubus Heart supports both genders.

Q: The MCM isn't showing and nothing seems to work!
A: Sounds like something installed incorrectly, try a clean install of the mod and make sure your files downloaded/extracted properly.

Q: _____ feels overpowered / underpowered, can you balance it?
A: I can try! If you have balance concerns make sure to send them my way and I'll work my best to work on it.

Q: I thought Soul Pets was going to be a completely separate mod, why is it now integrated?
A: In honesty I completely screwed up the stand-alone's code so instead of re-writing from scratch (again) I just moved onto making an integrated version first. I'll work on the stand-alone version at some point.

Q: But I didn't want Soul Pets, can it be removed?
A: No, however I've built it in such a way that it doesn't do anything if you don't use it so just ignore the Soul Pets MCM if you don't want to use it. Sorry!

Q: You're not making anymore Succubus Spells? What is "Legacy"?
A: Legacy refers to features that are in the mod but no longer supported, I didn't really feel like 'removing' more content in-case people wanted to still use it. As for spells I'm still working on Seduction (sex) spells but combat and support spells were impossible to balance and didn't really add to the mod in any interesting ways, so I'm spending that development time elsewhere.

Q: Why did you re-write the mod and end up removing features?
A: Removing features was never part of the plan but rather just a side effect. The original write was based on a flawed framework and the entire mod had become a grouping of work-around, causing bugs which I couldn't fix. The re-write allowed me to rebuild the foundation and build a more cohesive mod with better mechanics and synergy.

Recent Changes (Check the full changelog for more info)
[Spoiler]
Succubus Heart 4.18
- Changed Succubus Heart Logo is now in English (Lost my 'japanese' fonts when moving to my new SSD... worth.)
- Changed Succubus Realm no longer has a 'tree fence' and now has 'mountains'
- Changed Death Override's "Random Respawn" setting to "Force Random Respawn" which will bypass the new options (Also now defaults as Disabled)
- Added new Spawnpoint for Realm Disconnect which 'should' be at the last entrance you went through (Similar to Auto Saves)
- Added Realm Disconnect now asks where you'd like to spawn (Directly Back / Last Entrance / Random Location)
- Added "Absorb From NPCs" which allows/disallows NPC stats to be effected
- Removed casting time on Succubus Realm Connect/Disconnect Spells (will add combat detection later)
- Fixed XP Gain cost displaying incorrectly after leveling
_____
Succubus Heart 4.171
- NOTE : Thanks to a bug in the last version, I reset the Absorb Perk to 0
- Changed Absorb Perk levels slower and only levels through sex acts
- Changed Combat Seduction Cooldown is now 5 seconds on NPCs
- Changed/Fixed Modified return pet code and positioning to hopefully fix conflicts
- - - This should hopefully fix some players having pets randomly spawn dead or aggro
- Fixed all status gains counting toward the Absorb Perk
- Fixed Combat Seduction Cooldown not applying in release version
_____
Succubus Heart 4.17
- Added Cooldown to Combat Seduction (5 seconds for player, 10 seconds on NPCs)
- - - This is to add a bit more combat-ability to it, and prevent bugs from SexLab
- Added Return Pet spell which will de-summon pets
- Added Absorb Perk which levels by absorbing status from enemies (Grants XP Gain)
- Added Consumer Sperm Perk (Grants Max Health)
- Added Consumer Milk Perk (Grants Max Health)
- Added visual effect on the PC after an act (to signify absorption, just trying things)
- Fixed Soul Pets causing errors in Combat Seduction
- Fixed Perks Progress Bar Being Wonkey (I tried to divide float by int... for shame)
_____
Succubus Heart 4.16
- Added Perks MCM menu (system is WIP - Suggestions wanted!)
- Added Perk "Have Orgasm" - +12 BDSM per-rank
- Fixed Formal Beauty now shows the timer value in the description
- Fixed Pets can now only register losing desire on hit once every 5 seconds
- Fixed Seducer Passive not resetting when points are refunded
- Fixed Bristleback not appearing in Soul Pets Menu
- Fixed "Lose Items" setting always acting as enabled (For death override)
- Fixed? Pet's using wrong Desire values (Reported in 4.15, but not found in dev-build)
[/Spoiler] 